home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / zcdoc987.arc / zcommdoc.aa next >
Text File  |  1987-09-27  |  71KB  |  1,801 lines
  1.  
  2.  
  3.                                     Chuck Forsberg
  4.  
  5.                             The High Reliability Software
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                    User Manual for
  15.                                         ZCOMM
  16.  
  17.                             Universal Line Printer Edition
  18.  
  19.  
  20.                             ZCOMM Communications Software
  21.  
  22.                                          With
  23.                             TurboLearn(TM) Script Writer,
  24.                  Cybernetic Data Recovery(TM), Error Containment(TM),
  25.                                          and
  26.                                    OverThruster(TM)
  27.  
  28.                      User Supported Communications Software Tools
  29.  
  30.  
  31.  
  32.                                    User Manual for
  33.                                         ZCOMM
  34.                             Universal Line Printer Edition
  35.  
  36.  
  37.                           Copyright 1987 Omen Technology Inc
  38.                                  All Rights Reserved
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                              Omen Technology Incorporated
  45.  
  46.  
  47.                             The High Reliability Software
  48.  
  49.                          17505-V Northwest Sauvie Island Road
  50.                                 Portland Oregon 97231
  51.                               VOICE: 503-621-3406 :VOICE
  52.                       Modem: 503-621-3746 Speed 1200,2400,19200
  53.                            Compuserve:70007,2304  GEnie:CAF
  54.                           UUCP: ...!tektronix!reed!omen!caf
  55.  
  56.  
  57.  
  58.  
  59.         (C) 1987 Omen Tech Inc                                      Chapter 0
  60.  
  61.  
  62.         Revised 09-05-87                        Universal Line Printer Edition
  63.         ZCOMM User Manual                                                    2
  64.  
  65.  
  66.         1.  INTRODUCTION
  67.  
  68.                     Get a Handle on the Information Explosion with
  69.                    ZCOMM(TM) User Supported Communications Software
  70.  
  71.         ZCOMM helps collect, control, and transmit information with a minimum
  72.         of time, hassle, and expense.  Concise commands and unobtrusive
  73.         displays facilitate telecommunications instead of distracting.
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.         (C) 1987 Omen Tech Inc                          Chapter 1 Introduction
  120.  
  121.  
  122.         Revised 09-05-87                        Universal Line Printer Edition
  123.         ZCOMM User Manual                                                    3
  124.  
  125.  
  126.         2.  Collecting Information
  127.  
  128.         ZCOMM exchanges files with the widest range of computer systems and
  129.         networks with a complete set of error correcting file transfer
  130.         protocols.  Years of communications experience distilled in ZCOMM
  131.         deliver fast, reliable file transfers.  Unsolicited customer
  132.         testimonials chronicle accurate file transfers under conditions that
  133.         crash all other communications programs, thanks to Omen Technology's
  134.         Cybernetic Data Recovery(TM) compatible logic enhancements and
  135.         thorough protocol stress testing.
  136.  
  137.         + ZMODEM- How often has your modem disconnected when you were within
  138.           the last 1k of a long, expensive file transfer?  With ZCOMM's ZMODEM
  139.           file transfers, you can resume the transfer from where you were cut
  140.           off, without wasted time or phone charges!
  141.  
  142.           ZMODEM transfers files and commands with a uniquely user friendly
  143.           interface.  Unlike traditional protocols, only one command or menu
  144.           choice is needed to transfer files or download commands.
  145.  
  146.           ZMODEM provides maximum throughput with full integrity even with
  147.           timesharing systems, high speed buffered modems, and packet switched
  148.           networks.  ZMODEM sets the throughput record with 14 kilobit/second
  149.           TrailBlazer modems tested at Telebit Corp.
  150.  
  151.           Advanced features include text file translation, selective transfer
  152.           of updated files, remote file maintenance.  Security authentication*
  153.           disables Trojan Horse attacks.  ZMODEM supports modern operating
  154.           systems by preserving exact file contents and modification date,
  155.           even across multiple time zones.
  156.  
  157.           A 32 bit Cyclic Redundancy Check, five orders of magnitude more
  158.           sensitive than CRC-16 and billions of times more sensitive than
  159.           Crosstalk's XMODEM checksum protects critical data.
  160.  
  161.         + XMODEM ZCOMM supports the ubiquitous Ward Christensen "XMODEM"
  162.           protocol with Cybernetic Data Recovery(TM) and automatic file name
  163.           generation.  Exclusive Cybernetic Data Recovery(TM) transfers files
  164.           under conditions that crash other programs.
  165.  
  166.         + XMODEM CRC-16 Even in 1987, few commercial programs support 16 bit
  167.           CRC, the standard of XMODEM file transfer technology since 1981.
  168.           CRC-16 error detection is orders of magnitude more accurate than
  169.           checksum.  Cybernetic Data Recovery(TM) catches and corrects
  170.           transmission errors that confound other programs.
  171.  
  172.         + XMODEM-1k 1024 byte packets (incorrectly called YMODEM) increase
  173.           throughput with timesharing systems and networks.
  174.  
  175.         + True YMODEMTm batch file transfers preserve the exact file length
  176.           and creation date.
  177.  
  178.  
  179.         (C) 1987 Omen Tech Inc                          Chapter 2 Introduction
  180.  
  181.  
  182.         Revised 09-05-87                        Universal Line Printer Edition
  183.         ZCOMM User Manual                                                    4
  184.  
  185.  
  186.         + Convenient Kermit AutoDownload- saves keystrokes, resolves
  187.           incompatibilities that stymie other programs.
  188.  
  189.         + Kermit- transfers ASCII and binary files with IBM, CDC, Cray, DEC,
  190.           ICL, Harris, Honeywell, Pr1me, Tandem, Univac and other mainframes.
  191.           Kermit is necessary to accurately transfer files with many of these
  192.           systems which do not support XMODEM protocol.
  193.  
  194.           ZCOMM's 16 bit Kermit CRC is thousands of times more sensitive than
  195.           Crosstalk's 6 bit checksum.
  196.  
  197.         + Sliding Windows Kermit speeds file transfers with timesharing
  198.           systems, satellite and packet networks.  SuperKermit is the only
  199.           high throughput download protocol compatible with The Source(TM).
  200.  
  201.         + Advanced Kermit Server Access functions support standardized, low
  202.           cost networking.
  203.  
  204.         + X.PC- version supports low level flow control, error correction,
  205.           multiple virtual calls and concurrent data capture.
  206.  
  207.         + Compuserve B ASCII and binary transfers reduce file transfer costs
  208.           up to 60 per cent.
  209.  
  210.         + OverThruster(TM) Speeds XMODEM and Compuserve-B downloads.
  211.  
  212.         + ZCOMM supports bulletin boards and traditional communications
  213.           programs with MODEM7 batch, Telink/FIDO, and Clink/SEAlink file
  214.           transfer protocols. -
  215.  
  216.         + WXMODEM (Windowed XMODEM) speeds People-Link(TM) timesharing service
  217.           downloads.
  218.  
  219.         ZCOMM's protocols are more cost effective than the crude, unreliable
  220.         XMODEM support available with other programs, and are more useful than
  221.         undocumented proprietary protocols.  Unix and VMS C source code is
  222.         available for the public domain protocols.
  223.  
  224.  
  225.         2.1  Controlling Information
  226.  
  227.         ZCOMM's Full-Time Capture Buffer(TM) lets you flip back and forth or
  228.         search, scanning two hundred messages from bulletin boards in a couple
  229.         of minutes.  (It has to be seen to be believed.) To compose a reply,
  230.         call your favorite editor (the one you've already learned!) as a
  231.         subroutine without losing your place.
  232.  
  233.         ZCOMM's high speed screen driver - makes life easy and pleasant:
  234.  
  235.         + Easy on the eyes: ZCOMM supports No Flicker displays, up to 450 per
  236.           cent faster than DOS
  237.  
  238.  
  239.         (C) 1987 Omen Tech Inc                          Chapter 2 Introduction
  240.  
  241.  
  242.         Revised 09-05-87                        Universal Line Printer Edition
  243.         ZCOMM User Manual                                                    5
  244.  
  245.  
  246.         + VT102, VT100, TTY 5425, ANSI, Z19, VT52, TI 940, IBM 3101, TVI 9xx,
  247.           and ADM3a terminal emulations support on-line applications,
  248.           including Unix and VMS full screen editors.
  249.  
  250.         + Supports 80 and 132 columns, advanced displays (114x60, etc.)
  251.  
  252.         + VT100 character graphics and keyboard mapping support "visual"
  253.           programs.  Unlike Microsoft Access, Crosstalk, and most "VT100"
  254.           emulators, ZCOMM correctly displays EDT, SmartForm, AllIn1, and DEC
  255.           Store even at 9600 baud.
  256.  
  257.         + ANSI KAM and SRM modes allow applications to control keyboard action
  258.           and character echo.
  259.  
  260.         + Hardcopy Terminal Emulation previews printer output by converting
  261.           overprint sequences to bold or underlined characters.
  262.  
  263.         + Visual (silent) bell preserves domestic tranquillity
  264.  
  265.         + Settable parameters including number of lines and columns, border
  266.           color, default colors, autowrap, keyboard mapping enable.
  267.  
  268.         Full pathnames, directories, and wildcards support file transfers and
  269.         utility commands.  Output may be redirected to printers or appended to
  270.         files.  Files may be listed, paged, copied, renamed, searched, edited,
  271.         and deleted.  Accuracy and identity of files transmitted by any means
  272.         are verified by word count and two types of checksum/CRC's.  Matching
  273.         C Source code is available for many of these functions.
  274.  
  275.         ZCOMM can search files for lines matching a string, insensitive to
  276.         case.
  277.  
  278.  
  279.         2.2  Transmitting Information
  280.  
  281.         + A rich palette of editing and timing modes permit file and message
  282.           upload, even to fussy microcomputer Bulletin Boards.
  283.         + Convenient Split Screen option allows responsive local editing of
  284.           input lines before transmission.-
  285.         + Remote access for file transfers and DOS program execution with baud
  286.           rate detection and three passworded security levels.-
  287.         + Outcall Queue intersperses scheduled outgoing calls with incoming
  288.           messages on one modem line.-
  289.  
  290.  
  291.         2.3  Other Features
  292.  
  293.  
  294.         Interrupt driven modem input allows High speed operation with file
  295.         transfer and conversational terminal operation at 19200 bps and above.
  296.         One of 7 modem "ports" may be selected at any time.
  297.  
  298.  
  299.         (C) 1987 Omen Tech Inc                          Chapter 2 Introduction
  300.  
  301.  
  302.         Revised 09-05-87                        Universal Line Printer Edition
  303.         ZCOMM User Manual                                                    6
  304.  
  305.  
  306.         A real-time status line displays column, row, time, elapsed time,
  307.         transmission speed, and other important information.
  308.  
  309.         Soft keys provide convenient execution of common commands.
  310.  
  311.         ZCOMM is written in C for performance, portability and
  312.         maintainability.  ZCOMM loads quickly from a moderately sized
  313.         executable file with no cumbersome overlays.
  314.  
  315.         Almost two decades of telecommunications knowledge are distilled in
  316.         ZCOMM.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.         (C) 1987 Omen Tech Inc                          Chapter 2 Registration
  360.  
  361.  
  362.         Revised 09-05-87                        Universal Line Printer Edition
  363.         ZCOMM User Manual                                                    7
  364.  
  365.  
  366.         3.  ZCOMM REGISTRATION
  367.  
  368.         ZCOMM may be used without any legal obligation to make any payments to
  369.         Omen Technology or anybody else.  You may distribute the unmodified
  370.         ZCOMM.ARC file to as many friends as you wish.
  371.  
  372.         Registration buys you:
  373.  
  374.            + Your own unique ZCOMM Serial Number Password (ZSNP).  Your ZSNP
  375.              may be applied to copies of ZCOMM to be run on a single machine.
  376.  
  377.                 + Serialized copies of ZCOMM do not pause after the initial
  378.                   screen.
  379.  
  380.                 + Serialization activates the egrep, egrepm, expand, split,
  381.                   and ss commands.  Features denoted with ** are available in
  382.                   serialized copies of ZCOMM.
  383.  
  384.                 + Serialization more than doubles the circular buffer size.
  385.  
  386.            + A software disk with the current version of ZCOMM, The putsnp
  387.              program to serialize your copy of ZCOMM with your ZSNP, and the
  388.              tree structured "flash-up" help processor and help file included
  389.              in ZCOMMHLP.ARC.
  390.  
  391.            + Typeset pages of the complete 195 page Professional-YAM User
  392.              Manual, ready for insertion into a "PC-size" binder.
  393.  
  394.         REGISTRATION FEES:
  395.  
  396.            + Basic registration (ZSNP, disk, manual pages): $40.00
  397.  
  398.            + Domestic Shipping (UPS surface): $5.00
  399.              (Required except for prepaid mail orders)
  400.  
  401.            + Custom Binder (OPTIONAL): $10.00 additional
  402.  
  403.            + International Air Mail: $10.00 additional
  404.  
  405.            + UPS Second Day AIR (OPTIONAL): $5.00 additional
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.         (C) 1987 Omen Tech Inc                                 Chapter 3 ZCOMM
  420.  
  421.  
  422.         Revised 09-05-87                        Universal Line Printer Edition
  423.         ZCOMM User Manual                                                    8
  424.  
  425.  
  426.         4.  ZCOMM's Big Brother
  427.  
  428.         ZCOMM is the Little Brother of Professional-YAM.  As powerful as ZCOMM
  429.         is, more powerful than other user supported software, it pales beside
  430.         Omen Technology's commercial Professional-YAM software.
  431.  
  432.         Pro-YAM's TurboDial(TM) script language provides state of the art real
  433.         time pattern recognition, "regular expiression" string parsing, script
  434.         development aids, script encryption, queue management, extensive
  435.         logging facilities, and finely tuned security control unmatched in the
  436.         industry.
  437.  
  438.         Fortune 500 corporations use these exclusive features to support large
  439.         PC based telecommunications projects involving attended and unattended
  440.         operation.
  441.  
  442.         Specialized utility commands allow Pro-YAM and a PC or DG/One portable
  443.         to replace data line monitors in many applications.  Pro-YAM supports
  444.         Echoplex uploads and high speed data dumps in addition to the uniquely
  445.         accurate and robust XMODEM, YMODEM, ZMODEM, and Kermit protocol
  446.         transfers shared with ZCOMM.  Pro-YAM has many powerful utility
  447.         commands that earn it the sobriquet Integrated Communications Tools.
  448.  
  449.         Pro-YAM is available with the Tymnet X.PC link level protocol for
  450.         multiple, concurrent data transfers.
  451.  
  452.         Omen Technology also markets highly compatible Unix and Xenix flavors
  453.         of Pro-YAM.
  454.  
  455.         Omen Technology's Demand Upgrade(TM) technology and small company
  456.         responsiveness meet the support needs of a growing base of demanding
  457.         customers.
  458.  
  459.         Professional-YAM is a superset of ZCOMM; applications and scripts
  460.         developed on ZCOMM will operate with Pro-YAM.
  461.  
  462.         Pro-YAM is also published by the POLYTRON Corporation under the
  463.         trademark PowerCom.
  464.  
  465.         This ZCOMM manual omits descriptions of most of the Pro-YAM features
  466.         not included in ZCOMM.  The special symbol * denotes features not
  467.         included in ZCOMM.
  468.  
  469.         In some places you will see references to Chapter 99.  Pro-YAM manual
  470.         chapters not included in this document are designated by Chapter 99.
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.         (C) 1987 Omen Tech Inc                         Chapter 4 Rosetta Stone
  480.  
  481.  
  482.         Revised 09-05-87                        Universal Line Printer Edition
  483.         ZCOMM User Manual                                                    9
  484.  
  485.  
  486.         5.  ROSETTA STONE
  487.  
  488.         The following terms have specific meanings within this manual which
  489.         may not coincide with their usage elsewhere.
  490.  
  491.         Alphanumeric An alphanumeric character is either a letter or a decimal
  492.             digit 0 to 9.
  493.  
  494.         Baud A baud is a signaling unit conveying one or more bits of
  495.             information.  Baudrate is commonly (and usually incorrectly)
  496.             interchanged with bits per second.
  497.  
  498.         BPS is an abbreviation for "bits per second", a measure of
  499.             transmission speed.  ASCII Asynchronous transmission generally
  500.             uses 10 bits to transmit each character, so the speed in
  501.             characters per second is one tenth the speed measured in bits per
  502.             second.
  503.  
  504.         Capture The term function captures data from the remote into the
  505.             circular buffer.  This data may be paged back and forth with the
  506.             review function, or written to a disk file.
  507.  
  508.         Character Escape is a sequence of characters initiated by a backslash
  509.             character used to represent a control character or programmable
  510.             string using printable characters.  Character escapes are
  511.             described in Chapter 24.
  512.  
  513.         Cyclical Redundancy Check (CRC) is a datum (16 or 32 bits) generated
  514.             by a cyclic code.  The CRC-16 extension to the Ward Christensen
  515.             XMODEM protocol provides a high level of data integrity.  CRC-16
  516.             guarantees detection of all single and double bit errors,  all
  517.             errors with an odd number of error bits, all burst errors of
  518.             length 16 or less, 99.9969% of all 17-bit error bursts, and
  519.             99.9984 per cent of all possible longer error bursts.  The actual
  520.             performance is even better because the errors that sneak by CRC-16
  521.             are often detected by the other error checks simultaneously
  522.             applied by ZCOMM's Cybernetic Data Recovery(TM).  ZMODEM's 32 bit
  523.             CRC provides five orders of magnitude more accurate error
  524.             detection than XMODEM's CRC-16 a billion times more accurate than
  525.             8 bit checksum used by standard XMODEM..
  526.  
  527.         Download is the transfer of data from the remote system down to your
  528.             computer.
  529.  
  530.         DTR is an abbreviation for Data Terminal Ready.  Data Terminal Ready
  531.             is a signal sent by the computer to the modem to condition it to
  532.             accept commands or answer an incoming call.  When DTR is "dropped"
  533.             (switched off), the modem should disconnect from the line.
  534.  
  535.         Execute When a string parameter is executed, it is normally sent to
  536.             the remote (modem).  If it begins with "@", the remainder is
  537.  
  538.  
  539.         (C) 1987 Omen Tech Inc                         Chapter 5 Rosetta Stone
  540.  
  541.  
  542.         Revised 09-05-87                        Universal Line Printer Edition
  543.         ZCOMM User Manual                                                   10
  544.  
  545.  
  546.             executed as a ZCOMM command.
  547.  
  548.         Filespec Some ZCOMM commands instruct a remote Kermit server program
  549.             to send, receive, print, type, or delete one or more files.  The
  550.             syntax of this specification is defined by the remote Kermit
  551.             server program, not ZCOMM.  If filespec contains spaces, filespec
  552.             must be enclosed by double quotes.
  553.  
  554.         Flow Control restrains the speed of transmission to prevent loss of
  555.             data when a fast sender must communicate with a slower receiver.
  556.             Hardware signals, control characters, and protocol handshakes can
  557.             be used to provide restraint, singly or in combinations.
  558.  
  559.             SEE ALSO: handshake command, Flow Control Chapter 14
  560.  
  561.         Functions are operations supported by ZCOMM, such as a dir, type, s,
  562.             r, or t (term) command.  A command may set or reset mode[s],
  563.             change a parameter, or perform a function.
  564.  
  565.         Host Operation allows remote access of files and programs.
  566.  
  567.         Iff If and only if.
  568.  
  569.         Integrity in a data transfer protocol refers to the ability of the
  570.             protocol to guarantee a correct data transfer provided both sender
  571.             and receiver report a successful transfer.  Integrity is a
  572.             different measure of a file transfer protocol than robustness,
  573.             which is a measure of a protocol's ability to complete the
  574.             requested transfers in the presence of errors, independent of the
  575.             probability of undetected errors in the file transfer.
  576.  
  577.         Kermit ia an error correcting batch file transfer protocol developed
  578.             at Columbia University and elsewhere.  The Kermit protocol
  579.             supports text and binary file transfers with many mainframe
  580.             computers whose hardware and operating software preclude
  581.             implementation of high performance protocols.  Kermit
  582.             implementations exist for many mainframes that cannot support the
  583.             XMODEM protocol.
  584.  
  585.         Line Hit A burst of noise on a telephone line may generate modem data
  586.             errors.  A single noise burst may garble dozens of characters.
  587.             ZCOMM's Error Containment(TM) technology may be used to reduce the
  588.             number of characters garbled by each line hit.
  589.  
  590.         Modes Many modes are available to modify the way the term function
  591.             receives, displays, transmits, and stores data.
  592.  
  593.         Options Options apply to the Kermit, s, sx, sb, s7, st, r, rx, r7, rb,
  594.             and rc protocol file transfer commands.
  595.  
  596.  
  597.  
  598.  
  599.         (C) 1987 Omen Tech Inc                         Chapter 5 Rosetta Stone
  600.  
  601.  
  602.         Revised 09-05-87                        Universal Line Printer Edition
  603.         ZCOMM User Manual                                                   11
  604.  
  605.  
  606.         q.v. Quod Vide is Latin for "which see", an invitation to consult
  607.             information on the subject mentioned.
  608.  
  609.         Pathname is a complete file name, including disk and directories.
  610.  
  611.             EXAMPLE: c:/ZCOMM/PHODIR.T
  612.  
  613.  
  614.         Pathspec ... A pathspec consists of zero or more pathnames.
  615.  
  616.             Unambiguous and ambiguous (with wildcard characters) pathnames may
  617.             be specified in any combination.  The wildcard filename characters
  618.             * and ?  are allowed as described in the IBM DOS manual chapter
  619.             "Global Filename Characters".  Only the filename portion of the
  620.             pathname may contain wildcards.
  621.  
  622.             EXAMPLE: src/cmd/*.c is legal; src/*/foo.c is not.
  623.  
  624.  
  625.             An empty pathspec represents all files in the current directory on
  626.             the current disk.  A disk identifier without any file names
  627.             represents all files on that disk's current directory.  A
  628.             directory pathname expands to all files in the specified
  629.             directory.
  630.  
  631.             Sequences of the form %svar are replaced by the value (possibly
  632.             empty) of the string parameter svar.  If svar is not a string
  633.             parameter, no substitution is made.
  634.  
  635.             A pathspec may contain any combination of the above, separated by
  636.             spaces or tabs.
  637.  
  638.             If pathspec includes a disk specifier (such as a: or b:), ZCOMM
  639.             checks the disk specifier against the list of permissible disk
  640.             specifiers in the string parameter disks.
  641.  
  642.             The various filename expansions are especially useful in the
  643.             context of commands such as wc, sum, chek, crc, find, sb, and sz.
  644.             For example, wc applies to all files in the current directory, and
  645.             wc dir applies to all files in dir.
  646.  
  647.             ZCOMM pathnames may use / or \ to delimit directories.
  648.  
  649.         Regular Expressions control pattern matching and grouping of text by
  650.             the ss and egrep commands.  "Magic" characters specify the pattern
  651.             matching and grouping processes.
  652.  
  653.         Remote refers to the machine or terminal with which ZCOMM is
  654.             communicating.  This could be a direct RS-232 connection to a
  655.             local terminal, micro, mini, or mainframe, or a timesharing system
  656.             accessed through a modem and a global packet switched network.
  657.  
  658.  
  659.         (C) 1987 Omen Tech Inc                         Chapter 5 Rosetta Stone
  660.  
  661.  
  662.         Revised 09-05-87                        Universal Line Printer Edition
  663.         ZCOMM User Manual                                                   12
  664.  
  665.  
  666.         Restraint See "Flow Control" above.
  667.  
  668.         Restricted For security reasons, ZCOMM is restricted to prevent
  669.             unauthorized dial-in users from accessing private data or crashing
  670.             the system.  Certain commands are illegal when ZCOMM is
  671.             restricted, and only specified disk drives and directories may be
  672.             accessed.
  673.  
  674.         Review Function The last 32k characters of output from the remote may
  675.             be paged and searched online with the review function.  This data
  676.             may also be cut and pasted to disk files.
  677.  
  678.         Robustness in a file transfer protocol refers to the protocol's
  679.             ability to complete transfers in the presence of errors induced by
  680.             line noise or other sources.  Robustness is a different measure of
  681.             a file transfer protocol than integrity, a measure of the
  682.             probability of correct data transfer given a successful completion
  683.             of the transfer process.
  684.  
  685.         Script A script is a set of commands that control dialogues with the
  686.             user or a remote system.
  687.  
  688.         Script Level refers to the degree of nesting of scripts.  Level 0 is
  689.             called by the user directly, and each higher level is executed by
  690.             a gosub or other command from the previous level.
  691.  
  692.         Shell Escape is a DOS command or program called as a subroutine from
  693.             ZCOMM.  The phrase "shell escape" comes from the Unix(TM)
  694.             Operating System, whose command interpreter is called "the shell".
  695.  
  696.         Soft Keys Strings or commands may be assigned to the Soft Keys with
  697.             set commands, including those in the telephone directory "setup"
  698.             entry executed each time ZCOMM starts.  ZCOMM recognizes the forty
  699.             function key codes produced by the ten function keys F1 to F10.
  700.             F11 to F20 are obtained with a Shift key, F21 to F30 are obtained
  701.             with the Ctrl key, and F31 to F40 are obtained with the Alt key.
  702.             The cursor keys and extra function keys on 101 key Extended
  703.             Keyboards are also recognized.
  704.  
  705.             Strings or commands may be assigned to BS, ESC, Ins, Del, Home,
  706.             End, Up, Down, Left, Right, PgUp, and PgDn, overriding their
  707.             normal functions in the term function.
  708.  
  709.         String Some commands take a string argument.  If a string argument
  710.             contains spaces, tabs, and a semicolon, it must be enclosed by
  711.             double quotes (shift single quote on the IBM PC keyboard).
  712.             Control characters may be included in strings with character
  713.             escapes similar to those used by the C Programming Language.
  714.  
  715.         Term Function ZCOMM's Term Function provides the conversational
  716.             "connection" between the user and the remote.  The term function
  717.  
  718.  
  719.         (C) 1987 Omen Tech Inc                         Chapter 5 Rosetta Stone
  720.  
  721.  
  722.         Revised 09-05-87                        Universal Line Printer Edition
  723.         ZCOMM User Manual                                                   13
  724.  
  725.  
  726.             captures data from the remote into ZCOMM's circular buffer from
  727.             whence it may be displayed, printed, stored in a disk file, or
  728.             searched, cut and pasted by the review function.
  729.  
  730.         TWX Teletypewriter Exchange (Teletype Corp. TM).  A simple protocol
  731.             used to transmit files or paper tapes between dial-up
  732.             teleprinters.
  733.  
  734.         Upload is a transfer of data from your computer up to the remote
  735.             system.
  736.  
  737.         Writing When a receive file is open as a result of a create or t
  738.             filename command, data in the circular buffer is written out to
  739.             the receive file when the circular buffer fills up or when a w or
  740.             ALT-W command is given.
  741.  
  742.         XMODEM The Ward Christensen file transfer protocol uses 128 byte
  743.             packets, one byte control messages, and a one byte arithmetic
  744.             checksum.
  745.  
  746.         XMODEM/CRC A synonym for the enhanced Ward Christensen XMODEM protocol
  747.             using a Cyclic Redundancy Check (CRC-16).  Newer programs support
  748.             CRC-16 for better data integrity, but reliability is still
  749.             compromized by one byte control messages.
  750.  
  751.         XMODEM-1k XMODEM protocol with 1024 byte data packets, CRC-16, and one
  752.             byte control messages, sometimes incorrectly called ymodem.
  753.  
  754.         YMODEM YMODEM is a batch file transfer protocol with pathname, date,
  755.             file length and other file data in block 0, CRC-16 default, and
  756.             optional 1024 byte packets.  Many programs claiming to support
  757.             YMODEM actually use XMODEM with 1024 byte blocks; use ZCOMM's sx
  758.             -k and rx XMODEM commands with these mutants.
  759.  
  760.         XOFF, XON ASCII control characters control the flow of data.  XOFF
  761.             (Ctrl-S) stops and XON (Ctrl-Q) resumes the flow of data.  Chapter
  762.             29 provides an ASCII code chart with the names for the control
  763.             characters.
  764.  
  765.         {arg1 | arg2} One of the arguments separated by | is required.
  766.  
  767.         ZMODEM An advanced public domain file transfer protocol with
  768.             simplified human interface, crash recovery, high speed streaming,
  769.             sensitive 32 bit CRC, command download, security features, and
  770.             important file management functions.
  771.  
  772.         []  Optional argument.
  773.  
  774.         *   The special symbol * denotes features not included in ZCOMM.  **
  775.             Denotes features not included in userialized (unregistered) copies
  776.             of ZCOMM.
  777.  
  778.  
  779.         (C) 1987 Omen Tech Inc                         Chapter 5 Rosetta Stone
  780.  
  781.  
  782.         Revised 09-05-87                        Universal Line Printer Edition
  783.         ZCOMM User Manual                                                   14
  784.  
  785.  
  786.         6.  DESIGN PHILOSOPHY
  787.  
  788.         ZCOMM is a Command Driven Communications Tool.  Once learned, ZCOMM's
  789.         command interface is more powerful, faster, and less cumbersome than a
  790.         menu interface with equivalent choices.  Indeed, menus comprehensive
  791.         enough to describe all the nuances of ZCOMM's capabilities would take
  792.         up more memory than most computers can afford.  In addition, remote
  793.         operation of ZCOMM would be cumbersome due to transmission delays
  794.         while displaying the numerous menu pages that would be required.
  795.  
  796.         The design of ZCOMM's command interface has been influenced by the
  797.         MODEM series of programs, the Unix(TM) Operating System, the Berkeley
  798.         Editor (vi), CP/M(TM), and PC-DOS.
  799.  
  800.         Function keys F1 and F2 have been assigned with a logical grouping.
  801.         Wherever meaningful, F1 exits from a function, and F2 enters the
  802.         logical "next" function.
  803.  
  804.         From the command prompt, F2 enters the term function, and from there
  805.         another F2 enters the review function.
  806.  
  807.         Once in the review function (assuming it was called from the term
  808.         function), F1 exits back to the term function, from where another F1
  809.         exits to the command prompt.
  810.  
  811.         Another ethic guiding ZCOMM's design is respect for the user's
  812.         information.  The user's data is, after all, precisely what a modem
  813.         program is all about.  Status information is limited to one CRT line
  814.         to allow maximum screen size for data.  Fancy display modes such as
  815.         reverse video are used sparingly to avoid distracting from the user's
  816.         work.
  817.  
  818.         If you seek a video arcade modem game, ZCOMM will disappoint you.
  819.  
  820.         6.1  Circular Buffer
  821.  
  822.         The circular buffer remotely resembles the linear "capture buffer"
  823.         used by other modem programs.  Many ZCOMM commands involve the
  824.         circular buffer, including the t, f, wait, w, review, and close
  825.         commands.
  826.  
  827.         The term function uses the circular buffer as a first in, first out
  828.         (FIFO) buffer for data arriving from the remote.  The circular
  829.         organization of this buffer makes the most recent data available for
  830.         review and arbitrary writing to disk files.
  831.  
  832.         Data is inserted into the circular buffer via the insertion pointer
  833.         bufcq.  When the circular buffer is cleared, all pointers are set to
  834.         the beginning of the buffer (lowest memory address).  Incoming data is
  835.         stored at the location pointed to by the pointer, and then the pointer
  836.         is incremented to point to the next buffer location.  If this new
  837.  
  838.  
  839.         (C) 1987 Omen Tech Inc                       Chapter 6 Circular Buffer
  840.  
  841.  
  842.         Revised 09-05-87                        Universal Line Printer Edition
  843.         ZCOMM User Manual                                                   15
  844.  
  845.  
  846.         pointer value points past the end of the circular buffer, the pointer
  847.         is reset to the beginning of the buffer.  This pointer reset operation
  848.         is called pointer wraparound.  Data from the remote is placed in the
  849.         circular buffer exactly as it arrives from the remote,[1] with all 8
  850.         bits stored in memory.  The highest priority task of the term function
  851.         is to place modem data into the circular buffer.  If the free storage
  852.         remaining in the circular buffer falls below a certain level, (and iff
  853.         e mode is not in effect), ZCOMM sends an XOFF character to the remote
  854.         to stop the flow of data.
  855.  
  856.         Data may be taken from the circular buffer with three data removal
  857.         pointers.  The first removal pointer fetches data for display on the
  858.         CRT screen (Term Function Control Characters are decoded now), and for
  859.         scanning by the pattern match facility.  Another pointer fetches data
  860.         from the circular buffer for the line printer iff printer output has
  861.         been enabled with the l mode or by the ALT-L.  The last pointer
  862.         fetches data from the circular buffer for writing to a disk file if a
  863.         receive file has been opened.
  864.  
  865.         When the circular buffer has been filled and the XOFF character sent
  866.         to the remote, ZCOMM writes the contents of the circular buffer to the
  867.         receive file if a receive file has been opened.  ZCOMM then checks
  868.         whether any characters remain to be written to the printer.  When both
  869.         of these checks are satisfied, ZCOMM then sends an XON character to
  870.         the remote to resume the transmission of data.
  871.  
  872.         The ALT-W command can be used to write the contents of the circular
  873.         buffer to the receive file without waiting for the circular buffer to
  874.         fill up first.
  875.  
  876.         The 24kb[2] capacity of the circular buffer may be used to review the
  877.         most recent data received from the remote.  The review command allows
  878.         one to page back and forth through the data received from the remote.
  879.         Forwards and backwards string searches make it easy to locate
  880.         important text.  The review command also allows segments of the data
  881.         in the circular buffer to be selectively saved on disk (cut and
  882.         pasted).
  883.  
  884.  
  885.  
  886.         __________
  887.  
  888.          1. Exceptions: If c mode is in effect, ENQ and DLE are not stored in
  889.             the circular buffer.  They activate the Compuserve "B" protocol.
  890.             Timing considerations dictate this violation of ZCOMM's circular
  891.             buffer design philosophy.  Likewise, CAN is used for ZMODEM
  892.             AutoDownload with Z mode, and SOH activates Kermit AutoDownload
  893.             with K mode.
  894.  
  895.          2. 128 kb default on 32 bit flavors
  896.  
  897.  
  898.  
  899.         (C) 1987 Omen Tech Inc                      Chapter 6 Installing ZCOMM
  900.  
  901.  
  902.         Revised 09-05-87                        Universal Line Printer Edition
  903.         ZCOMM User Manual                                                   16
  904.  
  905.  
  906.         7.  INSTALLING ZCOMM
  907.  
  908.         If you have registered your copy of ZCOMM, make yourself a working
  909.         copy of the ZCOMM distribution disk using the DOS diskcopy command to
  910.         make exact copies.  Keep the distribution disk in a safe place away
  911.         from nasty data killers such as disk drives, displays, computers,
  912.         magnets, motors, and coffee cups.  The only time the distribution
  913.         diskette should be out and about is when you are cloning your working
  914.         copies.
  915.  
  916.  
  917.         7.1  Installation from Registration Disk
  918.  
  919.  
  920.         The putsnp program inserts your ZCOMM Serial-Number-Password (ZSNP)
  921.         into your working copiy of ZCOMM.  Installing a legal serial number
  922.         suppresses the pause after the opening message, enlarges the circular
  923.         buffer, and enables new commands.  The putsnp program prompts for your
  924.         Serial/Number/Password (SNP) of the form X123456789.  Putsnp checks
  925.         for keyboarding mistakes and then verifies that you understand and
  926.         agree to the licensing conditions.  When you understand and agree to
  927.         the licensing conditions, respond with yes (not just y).
  928.  
  929.         Then putsnp prompts for the name of a file to insert the serial number
  930.         into.  This should be a ZCOMM.EXE file that you have transferred to a
  931.         scratch disk, or to an appropriate directory on your hard disk.  Do
  932.         not write on the distribution diskette unless a nuclear attack is in
  933.         progress.
  934.  
  935.         After inserting the serial number in the given file, putsnp asks if
  936.         you wish to change the default value for the phone directory pathname
  937.         (string parameter phones).  This is normally /PHODIR.T.  If you wish
  938.         to keep the phones file elsewhere, answer "yes".[1] Putsnp then
  939.         searches for the location in your copy of ZCOMM that contains this
  940.         information.  When found, you may enter a new pathname,[2] up to 64
  941.         characters.
  942.  
  943.         Afterwards, you should copy the help processor files YHP.EXE and
  944.         ZMANH.HLP from the disk.
  945.  
  946.  
  947.  
  948.  
  949.  
  950.         __________
  951.  
  952.          1. The default value may also be overidden with the PHONES DOS
  953.             environment variable.
  954.  
  955.          2. Such as c:/zcomm/PHODIR.T.
  956.  
  957.  
  958.  
  959.         (C) 1987 Omen Tech Inc                      Chapter 7 Installing ZCOMM
  960.  
  961.  
  962.         Revised 09-05-87                        Universal Line Printer Edition
  963.         ZCOMM User Manual                                                   17
  964.  
  965.  
  966.         7.2  Installation from ZCOMM*.ARC
  967.  
  968.  
  969.         If you are using the software provided in ZCOMM*.ARC, be sure to save
  970.         the original files for backup, and pass them on to your friends to
  971.         fill their communications needs.  There are currently three ZCOMM
  972.         archive files:
  973.  
  974.           + ZCOMMEXE.ARC contains the executable program and demonstration
  975.             files.
  976.  
  977.           + ZCOMMDOC.ARC contains this documentation.
  978.  
  979.           + ZCOMMHLP.ARC contains ZCOMM's tree structured help file and random
  980.             access flash-up help processor.
  981.  
  982.  
  983.         7.3  Installation Continued
  984.  
  985.  
  986.         The second order of business is to read this manual.  There is just no
  987.         way you can get your money's worth out of ZCOMM without reading, or at
  988.         least carefully scanning, this manual.  After all, didn't you get
  989.         ZCOMM because you needed something more powerful than that cumbersome,
  990.         unreliable, brain-damaged menu driven crock you've been using?
  991.         (Perhaps you shouldn't answer that question just yet ...)
  992.  
  993.         You can then edit PHODIR.T to suit your own needs by inserting
  994.         directory entries for the systems you wish to call and changing the
  995.         phone numbers, account numbers, and passwords on the "standard"
  996.         entries for popular timesharing services that you have accounts with.
  997.         Be sure to check the setup entry and make any changes you feel
  998.         appropriate.  Once you have the "feel" of ZCOMM, you will want to
  999.         remove the automatic menu invocation at the end of the setup directory
  1000.         entry.
  1001.  
  1002.         Chapter 10 gives a line by line tutorial for setting up your telephone
  1003.         directory assuming you are using a standard modem.
  1004.  
  1005.         If you are using a computer that runs at non standard clock rates
  1006.         (e.g., 8 mHz 8088 instead of 4.77 mHz) or with an enhanced CPU chip
  1007.         (NEC V20), you will need to set special values for the a and b numeric
  1008.         parameters as described in Chapter 22.
  1009.  
  1010.         **** WARNING **** Although ZCOMM is well behaved as communications
  1011.         programs go, some memory resident programs, special keyboard
  1012.         modifiers, print spoolers, or special display drivers, may cause
  1013.         problems.  The POLYTRON memory-resident desktop organizer PolyWindows
  1014.         DeskPlus as well as POLYBoost work with ZCOMM.
  1015.  
  1016.         **** WARNING **** Since ZCOMM uses interrupts to read data from the
  1017.  
  1018.  
  1019.         (C) 1987 Omen Tech Inc                      Chapter 7 Installing ZCOMM
  1020.  
  1021.  
  1022.         Revised 09-05-87                        Universal Line Printer Edition
  1023.         ZCOMM User Manual                                                   18
  1024.  
  1025.  
  1026.         serial ports, each serial port must be strapped for its proper
  1027.         interrupt vector.  Some communications programs assign both IRQ3 and
  1028.         IRQ4 while operating, so they will operate even if the serial ports
  1029.         are not strapped properly.  Since ZCOMM only assigns the interrupt
  1030.         vector of the port in use, incorrect IRQ level strapping will crash
  1031.         ZCOMM.  Check the serial port addresses and vectors with the
  1032.         information given ith the port command in Chapter 17 if you encounter
  1033.         trouble starting ZCOMM.
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.         (C) 1987 Omen Tech Inc                     Chapter 7 Modem Interfacing
  1080.  
  1081.  
  1082.         Revised 09-05-87                        Universal Line Printer Edition
  1083.         ZCOMM User Manual                                                   19
  1084.  
  1085.  
  1086.         8.  MODEM INTERFACING
  1087.  
  1088.         ZCOMM accesses serial ports at the standard COM1 and COM2 address, as
  1089.         well as COM3-COM7 as described with the port command.  The portx
  1090.         command may be used to access non standard 8250 port addresses.
  1091.  
  1092.         When a port is selected, a quick hardware check is made to verify the
  1093.         existience and minimal functionality of the port.  If this test fails,
  1094.         the message Port N Defective is displayed.  An incorrect port switch
  1095.         or strap (jumper) configuration is the usual cause of this message.
  1096.  
  1097.         The hardware check does not check whether the port is connected to the
  1098.         proper IRQ line.  If the port is not configured to use the proper IRQ
  1099.         line, the computer may lock up when the port is used.
  1100.  
  1101.         If your telephone line supports Tone Dialing, set mprefix to ATDT with
  1102.         a command in the setup telephone directory entry.  If your telephone
  1103.         line only supports rotary (pulse) dialing, set mprefix to ATDP.
  1104.  
  1105.         Modem manufacturers are constantly refining their products and adding
  1106.         subtle new features.  To obtain the full performance your modem
  1107.         provides, you can edit initialization strings in the dialing scripts
  1108.         to take advantage of new modem features.  For example, changing the X1
  1109.         string sent by a dialing script to X4 enables extra features on some
  1110.         modems.
  1111.  
  1112.         If your modem is not listed in one of the following subchapters,
  1113.         please read all the subchapters and use the suggestions that apply to
  1114.         modems similar to yours.
  1115.  
  1116.  
  1117.         8.1  High Speed Modems
  1118.  
  1119.         The new generation of high speed dial-up modems presents special
  1120.         oppurtunities and challenges to hardware and software system
  1121.         integrators.
  1122.  
  1123.         These modems transmit data at varying speeds from 19200 bits per
  1124.         second to 300 or 110 bps.  This range of speeds poses special problems
  1125.         communicating between the computer and the modem.  Lower speed modems
  1126.         examine the traditional "AT" command prefix bit by bit to lock onto
  1127.         the computer's transmission speed instantly.  Many modems which
  1128.         recognize commands at widely varying speeds can not use this
  1129.         technique.  A number of alternate techniques have been developed, each
  1130.         with its own advantages and problems.
  1131.  
  1132.           + Lock the interface to the highest tranmsission rate.  This aviods
  1133.             the programming required to synchronize the modem's and computer's
  1134.             speeds.  Flow control must be used when the interface speed is
  1135.             locked to prevent the computer from sending data more rapidly than
  1136.             the modem can buffer and transmit it.  When such an arrangement is
  1137.  
  1138.  
  1139.         (C) 1987 Omen Tech Inc                     Chapter 8 Modem Interfacing
  1140.  
  1141.  
  1142.         Revised 09-05-87                        Universal Line Printer Edition
  1143.         ZCOMM User Manual                                                   20
  1144.  
  1145.  
  1146.             used to communicate over networks that must assert their own flow
  1147.             control, optimum regulation of the data flow becomes difficult if
  1148.             not impossible, especially during protocol error recovery.  The
  1149.             handshake both command should be used whenever the modem's
  1150.             interface speed is locked unless XMODEM or YMODEM transfers are
  1151.             required.
  1152.  
  1153.             When the interface speed is locked at a higher speed than the
  1154.             actual data transmission, an excessive amount of data may be
  1155.             stored in the modem's memory awaiting transmission.  This is most
  1156.             inefficient when a streaming file transfer protocol is used
  1157.             because the stored data must be drained before error recovery can
  1158.             commence.  The ZMODEM b and w muneric parameters should be used to
  1159.             manage the modem's data storage.
  1160.  
  1161.             Locking the interface speed to 9600 or 19200 bps while
  1162.             communicating at 1200 and 2400 bps should be avoided unless all
  1163.             links in the transmission path have effective error correction.
  1164.  
  1165.           + Autobaud to adjust the modem and computer speed.  With this
  1166.             method, the modem is optioned to enter a search mode whenever it
  1167.             becomes idle.  The dialing script calls the waketb phone directory
  1168.             subroutine to train the modem to the computer's transmission
  1169.             speed.  The waketb subroutine may be optimized for the particular
  1170.             modem used.
  1171.  
  1172.             After dialing or answering a call, the modem handshakes with the
  1173.             remote modem and reports the connect speed with a message such as
  1174.             "CONNECT 1200" or "CONNECT FAST".  The dialing script recognizes
  1175.             the string, and sets the computer to the correct speed.  If the
  1176.             connection is made at high speed, the dialing script may need to
  1177.             enable hardware flow control with a handshake command.
  1178.  
  1179.  
  1180.         8.2  TELEBIT TrailBlazer
  1181.  
  1182.         The Telebit TrailBlazer modem uses 68000 and TMS320 processors to
  1183.         transmit serial data at rates approaching 14000 bps over standard
  1184.         phone lines.  The modems also operate at speeds of 2400, 1200, 300 and
  1185.         slower.  Use the mm224 dialing routine discussed above for this modem.
  1186.         The mm224 dial routine has special provisions to operate this modem
  1187.         smoothly.
  1188.  
  1189.         Before making calls, use the inittb phone entry to initialize the
  1190.         modem's non volatile memory with proper settings for ZCOMM.
  1191.  
  1192.         EXAMPLE: call inittb
  1193.  
  1194.  
  1195.         The ZMODEM or Kermit Sliding Windows protocol should be used at high
  1196.         speeds to avoid interference with the modem's flow control.  ZMODEM
  1197.  
  1198.  
  1199.         (C) 1987 Omen Tech Inc                     Chapter 8 Modem Interfacing
  1200.  
  1201.  
  1202.         Revised 09-05-87                        Universal Line Printer Edition
  1203.         ZCOMM User Manual                                                   21
  1204.  
  1205.  
  1206.         provides optimum file transfer speeds with these modems.
  1207.  
  1208.  
  1209.         8.3  Microcom SX Series
  1210.  
  1211.         The Microcom MNP modems have a unique command set that is incompatible
  1212.         with Hayes modems.  Furthermore, careful attention must be paid to
  1213.         flow control issues to obtain reliable operation.  When using XMODEM
  1214.         or other protocols, the modem must be set to pass all 8 bits and all
  1215.         256 code combinations of those 8 bits.  The dialsx script sets the
  1216.         modem to "transparent software flow control" as described in Chapter
  1217.         14.  Change the line
  1218.              set mcommand "gosub dial"
  1219.         to
  1220.              set mcommand "gosub dialsx"
  1221.         in the setup telephone directory entry.
  1222.  
  1223.  
  1224.         8.4  MultiTech MultiModem 224
  1225.  
  1226.         The autobaud feature of this and most other 2400 bps modems is
  1227.         accessed with the mm224 dial script.  This dialing script is the
  1228.         default choice in the distribution phones.t file.  This modem will
  1229.         detect busy tones if the X1 in the mm224 dial script entry is changed
  1230.         to X4.
  1231.  
  1232.  
  1233.         8.4.1  Error Correcting 224  Set dip switch 1 on the bottom of the
  1234.         modem to up, the reverse of the factory setting.  Before making calls,
  1235.         use the initmm phone entry[1] to initialize the modem's non volatile
  1236.         memory with proper settings for ZCOMM.
  1237.  
  1238.         EXAMPLE: call initmm
  1239.  
  1240.         This enables automatic error correction under mnp.  If you ever wish
  1241.         to disable this setting, merely type, from the terminal mode, 'at &e0
  1242.         &w', and the 'ok' which will ensue tells you that the command was
  1243.         accepted and stored in non-volatile memory.
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.         __________
  1254.  
  1255.          1. Information courtesy Earle Robinson
  1256.  
  1257.  
  1258.  
  1259.         (C) 1987 Omen Tech Inc                     Chapter 8 Modem Interfacing
  1260.  
  1261.  
  1262.         Revised 09-05-87                        Universal Line Printer Edition
  1263.         ZCOMM User Manual                                                   22
  1264.  
  1265.  
  1266.         8.5  Smartmodem 2400
  1267.  
  1268.         The Hayes Smartmodem 2400 presents the same same considerations as the
  1269.         Smartmodem 1200 described above.  Unlike the 1200, the 2400 uses a non
  1270.         volatile memory to store configuration parameters instead of the
  1271.         switches used in earlier models.  The sequence AT&C1 &D2 &R1 &S1 &T5
  1272.         &W should be sent to the modem to set normal operation for DCD, DTR,
  1273.         CTS, and DSR.  The T5 command disables remote loopback request, a
  1274.         source of failed file transfers on noisy lines.  Finally, the &W
  1275.         command writes this information to the non volatile memory.  Please
  1276.         consult your Hayes manual for more information on these commands.
  1277.  
  1278.  
  1279.         8.6  Smartmodem 1200
  1280.  
  1281.         The Smartmodem 1200 and similar 1200 bps modems are compatible with
  1282.         the dial telephone directry entry.
  1283.  
  1284.         To select the dial telephone directory entry, change the line
  1285.              set mcommand "gosub mm224"
  1286.         to
  1287.              set mcommand "gosub dial"
  1288.         in the setup telephone directory entry.
  1289.  
  1290.         The Smartmodem 1200(TM) should be configured as follows by setting
  1291.         S1-S8, located under the front panel.  These switches may be accessed
  1292.         by gently prying the ears of the front bezel, allowing the bezel to
  1293.         pop off the front of the unit.
  1294.  
  1295.         S1 Up Support DTR Lead
  1296.         S2 Up Verbal result codes (Verbose) [2]
  1297.         S3 Down Result codes are sent
  1298.         S4 Up Echoes characters in command state
  1299.         S5 Down Modem does not answer calls initially
  1300.         S6 Up Carrier Detect line reads status
  1301.         S7 ????  See Hayes manual
  1302.         S8 Down Enables Smartmodem 1200 command recognition
  1303.  
  1304.         The modem cable should connect the following RS-232 circuits: AA BA BB
  1305.         AB CF CD which use pins 1,2,3,7,8, and 20 on the Hayes modem.  Some
  1306.         programs require pins 5 and 6 connected to the modem.
  1307.  
  1308.         NOTE: Some Hayes modems require mprefix to be in upper case only.
  1309.         "Hayes Compatible" modems not manufactured by Hayes generally work
  1310.  
  1311.  
  1312.         __________
  1313.  
  1314.          2. If other options are necessary (to support other software) a
  1315.             custom dial routine may be used as described in Chapter 99.
  1316.  
  1317.  
  1318.  
  1319.         (C) 1987 Omen Tech Inc                     Chapter 8 Modem Interfacing
  1320.  
  1321.  
  1322.         Revised 09-05-87                        Universal Line Printer Edition
  1323.         ZCOMM User Manual                                                   23
  1324.  
  1325.  
  1326.         with the same mprefix, but some of the other modem control strings
  1327.         that appear in the distributed PHODIR.T file may not work properly
  1328.         with a particular brand of modem.
  1329.  
  1330.  
  1331.         8.7  Novation Access 1-2-3
  1332.  
  1333.         Port "com3" as defined by Novation may not work properly with PC-DOS
  1334.         because it uses the same interrupt line as COM2, which is enabled by
  1335.         PC-DOS.  If your system already has serial ports for COM1 and COM2,
  1336.         the Novation board modem may be operated as COM6 by moving the jumper
  1337.         from J6 to J9 and moving the jumper from E4 to W2.  (W2 may have to be
  1338.         soldered.) COM6 uses Novation's COM3 port address and IRQ2 for
  1339.         interrupts.  Alternatively, you may connect the IRQ line on your
  1340.         regular second serial port to IRQ2 (accessing that port with a "port
  1341.         7" command) and access the Novation as COM5.[3]
  1342.  
  1343.         The modem prefix should be set to "%D I".  When initializing, the
  1344.         modem should be set to 8 bit data mode with a putw "%F 4\r" [4]
  1345.         command.  The phones2.t file should be used as a basis for your
  1346.         phones.t file if this is your main modem.
  1347.  
  1348.         The Novation modem must be explicitly commanded to change speed with a
  1349.         "call 1200" or "call 300".
  1350.  
  1351.         Some modems may latch up if they are disturbed while dialing.  The
  1352.         modems may have difficulty recognizing dial tone.  A Novation "W"
  1353.         command may be used to force a wait and bypass listening for the dial
  1354.         tone.  "W" command(s) after the phone number also be useful when
  1355.         attempting to handshake with V.22bis (2400 bps) modems.  A custom
  1356.         "dial" script can also be used to manage the peculiarities of these
  1357.         modems.
  1358.  
  1359.         Users of the PC-jr Smartcat(TM) or similar modems should set mprefix
  1360.         to "\16 D " to provide the necessary command sequence for dialing.
  1361.         Many of the Novation Smartcat considerations discussed above apply to
  1362.         the PC-jr version.
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.         __________
  1372.  
  1373.          3. IRQ2 may already be used by a mouse or special hard disk.
  1374.  
  1375.          4. See Chapter 24 for a description of character escapes.
  1376.  
  1377.  
  1378.  
  1379.         (C) 1987 Omen Tech Inc                     Chapter 8 Modem Interfacing
  1380.  
  1381.  
  1382.         Revised 09-05-87                        Universal Line Printer Edition
  1383.         ZCOMM User Manual                                                   24
  1384.  
  1385.  
  1386.         8.8  Prometheus ProModem 1200
  1387.  
  1388.         The following switch setting works with ZCOMM: 1-4,6,9 on; 5,7,8,10
  1389.         off.[5] A custom "dial" script can be written to operate this modem in
  1390.         its native mode.
  1391.  
  1392.  
  1393.         8.9  Racal-Vadic Maxwell 2400V
  1394.  
  1395.         The Maxwell 2400V has long delays designed to allow switching between
  1396.         data and voice operation on the same phone line.  Unfortunately, they
  1397.         slow normal data operations.  The 2400VP reportedly does not have this
  1398.         feature.
  1399.  
  1400.         Use the default mm224 dialing routine discussed above for this modem.
  1401.  
  1402.  
  1403.         8.10  Standard 103/212
  1404.  
  1405.         The supplied "dial" script will present the number to the user and
  1406.         wait for a success/fail response if the mprefix string parameter is
  1407.         set empty.  Alternatively, one could change the script to loop waiting
  1408.         for carrier detect while the keyboard is inactive.  The Data Set Ready
  1409.         (DSR) signal may be connected to the modem's speed detect output (high
  1410.         for 1200 bps, low for 300) allowing the dr test condition to sample
  1411.         the DSR line to determine the speed of the incoming call.
  1412.  
  1413.  
  1414.         8.11  Data Race BMX
  1415.  
  1416.         These modems have a switch selected interface speed, an AT style
  1417.         command set, and switch options for software or hardware flow control.
  1418.         Recommended settings are: AT commands, Dialup, 8 bit data (down),
  1419.         disable XON (7 and 8 down), Echo on.  ZCOMM's handshake on command
  1420.         should be used.
  1421.  
  1422.         8.12  Strange Modems
  1423.  
  1424.         Most intelligent modems can be commanded to autodial with a suitable
  1425.         mprefix and msuffix string.  Those modems that won't work with a
  1426.         particular mprefix can be programmed with a custom "dial" script.  If
  1427.         the modem can be configured to reset to a known condition when DTR is
  1428.         turned off, programming is usually straightforward.
  1429.  
  1430.  
  1431.         __________
  1432.  
  1433.          5. Prometheus mode does not work with ZCOMM's built-in dialing
  1434.             software because the "DIAL COMPLETED" message makes ZCOMM think
  1435.             it's seen "CONNECT" (ZCOMM looks for a "T").
  1436.  
  1437.  
  1438.  
  1439.         (C) 1987 Omen Tech Inc                     Chapter 8 Modem Interfacing
  1440.  
  1441.  
  1442.         Revised 09-05-87                        Universal Line Printer Edition
  1443.         ZCOMM User Manual                                                   25
  1444.  
  1445.  
  1446.         Otherwise, the script must determine what speed the modem is set to,
  1447.         and then,  at its present speed, command the modem to change to the
  1448.         desired speed.  The essential requirement is to write a script that
  1449.         controls the modem and responds to its state.  The information on
  1450.         scripts in Chapter 99 should prove useful.
  1451.  
  1452.  
  1453.         8.13  Manual Dialing with Smart Modems
  1454.  
  1455.         Some hotels and exotic locales sport telephone systems with unusual
  1456.         dialing requirements.  It may be necessary to dial the call with the
  1457.         telephone, talk to an operator, and then activate the modem.  With
  1458.         Hayes compatible modems, an ATD command may be given to the modem to
  1459.         connect it to the line and attempt a data handshake.
  1460.  
  1461.  
  1462.         8.14  Direct Connection
  1463.  
  1464.         ZCOMM works well communicating with locally connected microcomputers,
  1465.         minicomputers, or mainframes with direct RS-232 connections.  For such
  1466.         applications, only transmit and receive data data signals need be
  1467.         connected to the computer.  The Carrier Detect line[6] should be
  1468.         driven ON (+5 volts) to prevent noise on this signal by strapping it
  1469.         to Data Terminal Ready [7] if no other signal is available.
  1470.  
  1471.         In the absence of ground noise generated by heavy machinery, foil
  1472.         shielded cable has worked well at 19200 bps and a few hundred feet.
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.         __________
  1492.  
  1493.          6. Pin 8 on 25 pin RS-232 connector, pin 1 on PC-AT 9 pin connector.
  1494.  
  1495.          7. Pin 20 on RS-232 connector, pin 4 on PC-AT 9 pin connector.
  1496.  
  1497.  
  1498.  
  1499.         (C) 1987 Omen Tech Inc              Chapter 8 Your Telephone Directory
  1500.  
  1501.  
  1502.         Revised 09-05-87                        Universal Line Printer Edition
  1503.         ZCOMM User Manual                                                   26
  1504.  
  1505.  
  1506.         9.  YOUR TELEPHONE DIRECTORY
  1507.  
  1508.         ZCOMM's telephone directory is a big flexibility advantage over
  1509.         traditional communications programs which require one or more separate
  1510.         files for each system called, or limit directory information to little
  1511.         more than a telephone number.
  1512.  
  1513.         The telephone directory is a plain ASCII text file which can be edited
  1514.         with standard text editors (brief, teco, EMACS, edlin, etc.).
  1515.         Normally, ZCOMM expects to find the telephone directory in the file
  1516.         /PHODIR.T on the current disk.  The pathname may be changed with the
  1517.         DOS environment variable PHONES.
  1518.  
  1519.         EXAMPLE: C>set PHONES c:/ZCOMM/lib/PHODIR.T
  1520.  
  1521.  
  1522.         The putsnp program may also be used to change ZCOMM's default, as
  1523.         described above.
  1524.  
  1525.         The call command is normally used to make a connection with another
  1526.         computer.  When you give a call name command, ZCOMM prepares for a
  1527.         modem call and then searches the telephone directory file for a line
  1528.         starting with name.
  1529.  
  1530.         It is not necessary to type the entire name as it appears in the file.
  1531.         ZCOMM will find the first entry that name is a prefix of.
  1532.  
  1533.         EXAMPLE: call cis would access either the cis300 or cis1200 telephone
  1534.         directory entry, whichever was first.
  1535.  
  1536.         When using two entries with similar names (such as "cis300" and
  1537.         "cis1200"), place the favorite entry first.  This way you can just
  1538.         type call cis to get the desired entry.
  1539.  
  1540.         If the search is successful, the call command copies the complete
  1541.         directory entry name to the remote string parameter, where it can be
  1542.         used for log entries and automatic password generation.
  1543.  
  1544.         ZCOMM executes the commands on the rest of the line (if any), and on
  1545.         succeeding lines beginning with a space or tab.
  1546.  
  1547.         There is no arbitrary limit to the size of the telephone directory.
  1548.         Popular entries may be placed near the front to minimize searching
  1549.         time.  Scripts can also be placed in separate files when desired.
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.         (C) 1987 Omen Tech Inc              Chapter 9 Your Telephone Directory
  1560.  
  1561.  
  1562.         Revised 09-05-87                        Universal Line Printer Edition
  1563.         ZCOMM User Manual                                                   27
  1564.  
  1565.  
  1566.         9.1  Customizing Your Telephone Directory
  1567.  
  1568.         Your next step is to edit the distribution PHODIR.T to suit your
  1569.         needs.
  1570.  
  1571.         When ZCOMM begins execution, it searches the telephone directory for
  1572.         the setup entry.  (A directory entry has the entry name starting at
  1573.         the left margin.)
  1574.  
  1575.  
  1576.         The setup telephone directory in the distributed phodir.t file invokes
  1577.         a demonstration menu.  Once you have exercized the various
  1578.         demonstration possibilities, search for the xsetup telephone directory
  1579.         and change it to setup be removing the "x".  This will blank out the
  1580.         oroginal setup entry which appears later in the file.
  1581.  
  1582.         setup     port 1
  1583.  
  1584.         The first line of the "setup" entry selects port 1.
  1585.  
  1586.              : if !c speed 1200 putw "ATZ\r"
  1587.  
  1588.         This line is commented out with a colon (:).  If the colon is removed,
  1589.         the speed is changed to 1200 and ZCOMM sends an initialization command
  1590.         to the modem if no carrier signal is present.  If a carrier signal is
  1591.         present (modem still connected to the remote computer), the speed is
  1592.         not changed, and no initialization command is sent to the modem.
  1593.  
  1594.              pd1; pz480
  1595.  
  1596.         enables incoming time/date information provided by the YMODEM and
  1597.         ZMODEM Batch protocols.  Time/date stamping of transmitted files
  1598.         provides many advantages over traditional protocols, including the
  1599.         ability to selectively transmit files if the source file is newer than
  1600.         receiver's copy.  The number in the pz480 command should represent the
  1601.         local time zone expressed as minutes behind GMT.[1]
  1602.  
  1603.         This line should be commented out with a leading colon (or removed) if
  1604.         you use a backup program that depends on the dates of files to
  1605.         determine which to save.
  1606.  
  1607.              set mprefix "ATDP"
  1608.  
  1609.         sets the string parameter mprefix to ATDP, setting the Hayes modem to
  1610.         use rotary (pulse) dialing.  If your phone uses tone dialing, comment
  1611.  
  1612.  
  1613.         __________
  1614.  
  1615.          1. Pacific Standard Time is 480 minutes behind Greenwich Mean Time
  1616.  
  1617.  
  1618.  
  1619.         (C) 1987 Omen Tech Inc              Chapter 9 Your Telephone Directory
  1620.  
  1621.  
  1622.         Revised 09-05-87                        Universal Line Printer Edition
  1623.         ZCOMM User Manual                                                   28
  1624.  
  1625.  
  1626.         that line out (place a leading colon to make ZCOMM pass over it) and
  1627.         uncomment the line containig "ATDT".
  1628.  
  1629.              set l "1"; set m "1"
  1630.  
  1631.         The l and m string parameters support the dynamic selection of one or
  1632.         more ALDS alternate long distance carriers.  The default values for
  1633.         these parameters is the digit 1.
  1634.  
  1635.         When making entries in your telephone directory, use %l- for numbers
  1636.         with different area codes, and %m- for numbers with the same area code
  1637.         as yours.
  1638.  
  1639.         The set command sets the string parameter l (lower case L) to 1
  1640.         (number), providing for normal long distance access.  If you have an
  1641.         alternative long distance service, set this parameter to the required
  1642.         access string for that service.[2] The "set m 1" command sets the
  1643.         string parameter m to 1, providing for normal long distance access for
  1644.         numbers in your same area code.  If you have an alternative long
  1645.         distance service, set this parameter to the required access string for
  1646.         that service, plus your area code if required. (Some alternate long
  1647.         distance services require the area code for all calls, even those in
  1648.         your own area code.)
  1649.  
  1650.              set answerback "YOUR NAME CITY\r\n\21"
  1651.  
  1652.         Change the answerback setting to reflect your name.[3] Be sure to keep
  1653.         the \21 at the end of the string.[4]
  1654.  
  1655.         The next lines configure soft keys F3-F14.  Their functions are
  1656.         described at the end of Chapter 17.
  1657.  
  1658.              : display bell=visual
  1659.  
  1660.         Causes bell characters to be displayed as a non spacing flashing
  1661.         musical note instead of sounding.  If you want a silent bell,
  1662.         uncomment this line.
  1663.  
  1664.              set quitcmd "\003\336off\r"
  1665.  
  1666.         This string is sent to the remote before disconnecting when an ALT-Q
  1667.  
  1668.  
  1669.         __________
  1670.  
  1671.          2. Use the "setsavenet" entry in PHODIR.T as a prototype.
  1672.  
  1673.          3. Some timesharing systems may require a specific answerback string.
  1674.  
  1675.          4. See Chapter 24 for a description character escapes.
  1676.  
  1677.  
  1678.  
  1679.         (C) 1987 Omen Tech Inc              Chapter 9 Your Telephone Directory
  1680.  
  1681.  
  1682.         Revised 09-05-87                        Universal Line Printer Edition
  1683.         ZCOMM User Manual                                                   29
  1684.  
  1685.  
  1686.         is typed during a protocol file transfer.
  1687.  
  1688.              : set calllog c:/calllog
  1689.              : set rxlog c:/tmp/rxlog
  1690.              : set txlog c:/tmp/txlog
  1691.  
  1692.         The above lines set the pathnames for logs of calls, files received,
  1693.         and files transmitted.  The above log file entries must be commented
  1694.         out for use with ZCOMM.
  1695.  
  1696.              set f10 "@help"
  1697.              if fyamhelp.t set helpfile "yamhelp.t"
  1698.              if f/umanh.hlp set helpfile "@yhp /umanh.hlp"
  1699.              if fumanh.hlp set helpfile "@yhp umanh.hlp"
  1700.  
  1701.         The above lines locate the help file and program F-10 to summon the
  1702.         help processor if available.  These lines may be changed if you keep
  1703.         these files in other directories.
  1704.  
  1705.              : if dc ps4 pn2 pr97
  1706.  
  1707.         If a color display is used, these colors may be more suitable than the
  1708.         default black and white.  Uncommenting this line selects red status
  1709.         line (ps4), green normal text (pn2), and a blue/yellow for reverse
  1710.         video (pr97).  Another possibility is "pn3" which selects blue-green
  1711.         for normal text.  You may wish to experiment with these values to find
  1712.         ones best suited for your particular combination of display equipment
  1713.         and visual preferences.  Changing the colors from time to time may
  1714.         prolong display tube life.
  1715.  
  1716.         Some programs, including the "DEC Store" demonstration, will not
  1717.         display as intended with some combinations of the above display
  1718.         parameters.
  1719.  
  1720.         you have more than one copy/license allowing you to use ZCOMM on
  1721.         multiple computers. Or, you might use ZCOMM with multiple operating
  1722.         systems on one computer. You may wish to keep your phone numbers etc.
  1723.         in one file and relegate information specific to each computer to a
  1724.         separate file.  The setup entry checks for the existience of a
  1725.         PHONES.TS file and executes it of found.
  1726.  
  1727.              set s0 ""
  1728.              setc pho "%PHONES\&s";  if f%pho source %pho
  1729.              if %s0 return
  1730.  
  1731.         The supplied PHONES.TS file is used on Omen's 386 Xenix system, and
  1732.         may be used as an example.
  1733.  
  1734.         While editing your telephone directory, you might wish to add some
  1735.         entries for your favorite systems in the same format used by the
  1736.         "amrad", "amsat", or "denver" directory entries.
  1737.  
  1738.  
  1739.         (C) 1987 Omen Tech Inc              Chapter 9 Your Telephone Directory
  1740.  
  1741.  
  1742.         Revised 09-05-87                        Universal Line Printer Edition
  1743.         ZCOMM User Manual                                                   30
  1744.  
  1745.  
  1746.         When the PHODIR.T file is ready, type "ZCOMM<ENTER>" to run ZCOMM.
  1747.         ZCOMM will print several lines of greeting and then silently execute
  1748.         the commands in the "setup" directory entry.
  1749.  
  1750.         If ZCOMM displays Illegal Serial Number, run putsnp on ZCOMM.EXE.
  1751.  
  1752.         If ZCOMM can't open PHODIR.T, exit ZCOMM with "x<ENTER>" and copy
  1753.         PHODIR.T to the correct directory, or set the DOS PHONES environment
  1754.         variable to the actual pathname (see Chapter 15).
  1755.  
  1756.         Also check that the DOS CONFIG.SYS files contains FILES=20 to allow
  1757.         ZCOMM a sufficient number of open files for proper script operation.
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.         (C) 1987 Omen Tech Inc                 Chapter 9 Tutorial Introduction
  1800.  
  1801.